@babel/plugin-proposal-async-generator-functions

What is @babel/plugin-proposal-async-generator-functions?

The @babel/plugin-proposal-async-generator-functions package is a Babel plugin that allows you to use async generator functions and for-await-of loops in your JavaScript code, which are part of the ECMAScript 2018 (ES9) specification. This plugin transforms async generator functions and for-await-of loops into code that can run in environments that do not support these features natively.

What are @babel/plugin-proposal-async-generator-functions's main functionalities?

Async Generator Functions

This feature allows you to define asynchronous generator functions using the async function* syntax. These functions can yield values using the yield keyword, and they return an AsyncIterator which can be used with for-await-of loops.

async function* asyncGenerator() {
  var i = 0;
  while (i < 3) {
    yield i++;
  }
}

For-Await-Of Loops

This feature enables you to iterate over AsyncIterables using a for-await-of loop. The loop will wait for each promise returned by the AsyncIterable to resolve before continuing to the next iteration.

async function iterateAsyncGenerator() {
  for await (const value of asyncGenerator()) {
    console.log(value);
  }
}

Other packages similar to @babel/plugin-proposal-async-generator-functions

regenerator-runtime

The regenerator-runtime package provides a runtime for Regenerator-compiled generator and async functions. It is similar to @babel/plugin-proposal-async-generator-functions in that it allows you to use generators and async functions in environments that do not support them natively. However, it is a runtime library rather than a compile-time Babel plugin.

babel-preset-env

babel-preset-env is a Babel preset that includes various plugins to transpile modern JavaScript to backwards-compatible versions. It includes plugins for async functions and generators, similar to @babel/plugin-proposal-async-generator-functions, but it is more comprehensive as it covers a wider range of JavaScript features and proposals.

README

@babel/plugin-proposal-async-generator-functions

Turn async generator functions into ES2015 generators

See our website @babel/plugin-proposal-async-generator-functions for more information.

Install

Using npm:

npm install --save-dev @babel/plugin-proposal-async-generator-functions

or using yarn:

yarn add @babel/plugin-proposal-async-generator-functions --dev

Changelog

v7.20.7 (2022-12-22)

:eyeglasses: Spec Compliance

• babel-helper-member-expression-to-functions, babel-helper-replace-supers, babel-plugin-proposal-class-properties, babel-plugin-transform-classes
  • #15223 fix: Deleting super property should throw (@SuperSodaSea)
• babel-helpers, babel-plugin-proposal-class-properties, babel-plugin-transform-classes, babel-plugin-transform-object-super
  • #15241 fix: Throw correct error types from sed ant class TDZ helpers (@SuperSodaSea)

:bug: Bug Fix

• babel-parser, babel-plugin-transform-typescript
  • #15209 fix: Support auto accessors with TypeScript annotations (@liuxingbaoyu)
• babel-traverse
  • #15287 Fix .parentPath after rename in SwitchCase (@nicolo-ribaudo)
• babel-plugin-transform-typescript, babel-traverse
  • #15284 fix: Ts import type and func with duplicate name (@liuxingbaoyu)
• babel-plugin-transform-block-scoping
  • #15278 Fix tdz analysis for reassigned captured for bindings (@nicolo-ribaudo)
• babel-plugin-proposal-async-generator-functions, babel-preset-env
  • #15235 fix: Transform for await with shadowed variables (@liuxingbaoyu)
• babel-generator, babel-plugin-proposal-optional-chaining
  • #15258 fix: Correctly generate (a ?? b) as T (@liuxingbaoyu)
• babel-plugin-transform-react-jsx, babel-types
  • #15233 fix: Emit correct sourcemap ranges for JSXText (@liuxingbaoyu)
• babel-core, babel-helpers, babel-plugin-transform-computed-properties, babel-runtime-corejs2, babel-runtime-corejs3, babel-runtime
  • #15232 fix: Computed properties should keep original definition order (@SuperSodaSea)
• babel-helper-member-expression-to-functions, babel-helper-replace-supers, babel-plugin-proposal-class-properties, babel-plugin-transform-classes
  • #15223 fix: Deleting super property should throw (@SuperSodaSea)
• babel-generator
  • #15216 fix: Print newlines for leading Comments of TSEnumMember (@liuxingbaoyu)

:nail_care: Polish

• babel-plugin-transform-block-scoping, babel-traverse
  • #15275 Improve relative execution tracking in fn exprs (@nicolo-ribaudo)

:house: Internal

• babel-helper-define-map, babel-plugin-transform-property-mutators
  • #15274 Inline & simplify @babel/helper-define-map (@nicolo-ribaudo)
• babel-core, babel-plugin-proposal-class-properties, babel-plugin-transform-block-scoping, babel-plugin-transform-classes, babel-plugin-transform-destructuring, babel-plugin-transform-parameters, babel-plugin-transform-regenerator, babel-plugin-transform-runtime, babel-preset-env, babel-traverse
  • #15200 Rewrite transform-block-scoping plugin (@nicolo-ribaudo)

:running_woman: Performance

• babel-helper-compilation-targets
  • #15228 perf: Speed up getTargets (@liuxingbaoyu)